home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / ieg2mips.z / ieg2mips
Encoding:
Text File  |  2002-10-03  |  6.2 KB  |  142 lines
  1. IEG2MIPS(3F)                                          Last changed: 2-11-99
  2.  
  3.  
  4. NNAAMMEE
  5.      IIEEGG22MMIIPPSS, MMIIPPSS22IIEEGG - Converts generic IEEE data to MIPS IEEE data and
  6.      vice versa
  7.  
  8. SSYYNNOOPPSSIISS
  9.      IINNTTEEGGEERR IIEEGG22MMIIPPSS, MMIIPPSS22IIEEGG
  10.  
  11.      _i_e_r_r == IIEEGG22MMIIPPSS((_t_y_p_e,, _n_u_m,, _f_o_r_e_i_g_n,, _b_i_t_o_f_f,, _n_a_t_i_v_e,, _s_t_r_i_d_e,, _n_a_t_l_e_n,,
  12.      _f_o_r_l_e_n[[,,_n_a_t_i_v_e_c_h]]))
  13.  
  14.      _i_e_r_r == MMIIPPSS22IIEEGG((_t_y_p_e,, _n_u_m,, _f_o_r_e_i_g_n,, _b_i_t_o_f_f,, _n_a_t_i_v_e,, _s_t_r_i_d_e,, _n_a_t_l_e_n,,
  15.      _f_o_r_l_e_n[[,,_n_a_t_i_v_e_c_h]]))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      IIEEGG22MMIIPPSS converts generic IEEE data types (abbreviated as "IEEE" in
  22.      the following text) to data for systems that use MIPS IEEE data types
  23.      (abbreviated as "MIPS" in the following text).
  24.  
  25.      MMIIPPSS22IIEEGG converts MIPS IEEE data types to IEEE data types.
  26.  
  27.      When using the MIPSpro 7 Fortran 90 compiler on IRIX systems, all
  28.      arguments must be of default kind unless documented otherwise.  On
  29.      IRIX systems, the default kind is KKIINNDD==44.
  30.  
  31.      The following is a list of valid parameters for this routine.
  32.  
  33.      _t_y_p_e    An integer giving the data type code, as follows.
  34.  
  35.              CCooddee   DDeessccrriippttiioonn
  36.  
  37.              1      Typeless (no translation; _n_a_t_l_e_n and _f_o_r_l_e_n must be
  38.                     equal and must be 8-, 16-, 32-, 64-, 128-, or
  39.                     256-bits.)
  40.  
  41.              2      Integer
  42.                     IEEE:  64-, 32-, 16, or 8-bit twos complement
  43.                     MIPS:  64-, 32-, 16, or 8-bit twos complement
  44.  
  45.              3      Real
  46.                     IEEE:  32-, 64-, or 128-bit IEEE floating-point
  47.                     MIPS:  32-, 64-, or 128-bit MIPS IEEE floating-point
  48.  
  49.              4      Complex
  50.                     IEEE:  2 x 32-, 64-, or 128-bit IEEE floating-point
  51.                     MIPS:  2 x 32-, 64-, or 128-bit MIPS IEEE
  52.                     floating-point
  53.  
  54.              5      Logical
  55.                     IEEE: 64-, 32-, 16-, or 8-bit zero/nonzero logical
  56.                     MIPS: 64-, 32-, 16-, or 8-bit zero/nonzero logical
  57.  
  58.              6      Character
  59.                     ASCII to ASCII; no translation.
  60.  
  61.              The _n_a_t_l_e_n and _f_o_r_l_e_n parameters select the size of the data.
  62.  
  63.      _n_u_m     Number of data items to convert.  Type integer variable,
  64.              expression, or constant.
  65.  
  66.      _f_o_r_e_i_g_n Variable or array of any noncharacter type or length to
  67.              contain data which is not native to the current system.
  68.  
  69.      _b_i_t_o_f_f  Integer variable, expression, or constant giving the bit
  70.              offset within the _f_o_r_e_i_g_n data variable or array to begin the
  71.              conversion.  _b_i_t_o_f_f must be at least 0 and no more than 63.
  72.  
  73.      _n_a_t_i_v_e  Variable or array of any noncharacter type or length to
  74.              contain data which is native to the current system. This
  75.              variable or array should be of a type that corresponds to
  76.              _t_y_p_e.  If _t_y_p_e=6, use a dummy integer variable and the
  77.              _n_a_t_i_v_e_c_h parameter (see description of _n_a_t_i_v_e_c_h).
  78.  
  79.      _s_t_r_i_d_e  Integer variable or constant giving the memory increment for
  80.              loading or storing data to the native array.  For two and
  81.              four-word items (complex and double-precision), this is a
  82.              stride of items, not of words.  For typeless, stride is always
  83.              in words.
  84.  
  85.              This parameter is ignored for CHARACTER (_t_y_p_e = 6).  Data in
  86.              the foreign array is loaded or stored in a continuous bit
  87.              stream regardless of this parameter.
  88.  
  89.      _n_a_t_l_e_n  Native storage length of an item, in bits.  For COMPLEX data,
  90.              _n_a_t_l_e_n counts the total size of the real and imaginary
  91.              component.
  92.  
  93.      _f_o_r_l_e_n  Foreign storage length of an item, in bits.  For COMPLEX data,
  94.              _f_o_r_l_e_n counts the total size of the real and imaginary
  95.              components.
  96.  
  97.      _n_a_t_i_v_e_c_h
  98.              Optional character parameter specifying _n_a_t_i_v_e target variable
  99.              if it is of type character (_t_y_p_e = 6).  This parameter is
  100.              ignored if _t_y_p_e is not character.
  101.  
  102. CCAAUUTTIIOONN
  103.      The _f_o_r_e_i_g_n and _n_a_t_i_v_e variables should not be associated (aliased to
  104.      each other).
  105.  
  106. RREETTUURRNN VVAALLUUEESS
  107.      The returned function values are as follows:
  108.  
  109.      <<00   Parameter error; no translation performed.
  110.  
  111.      --11   Parameter error; too few arguments or _n_a_t_i_v_e_c_h not specified with
  112.           _t_y_p_e = 6. This error is not returned on IRIX systems.
  113.  
  114.      --22   Parameter error; invalid _t_y_p_e.
  115.  
  116.      --33   Parameter error; invalid _n_u_m.
  117.  
  118.      --44   Parameter error; invalid _b_i_t_o_f_f.
  119.  
  120.      --55   Parameter error; invalid _n_a_t_l_e_n.
  121.  
  122.      --66   Parameter error; invalid _f_o_r_l_e_n.
  123.  
  124.      --77   Unable to mmaalllloocc() memory for translation.
  125.  
  126.      --88   Combination of _n_a_t_l_e_n and _f_o_r_l_e_n is invalid.
  127.  
  128.      --99   _n_a_t_i_v_e must be 64-bit word-aligned.
  129.  
  130.      --1100  _f_o_r_e_i_g_n must be 64-bit word-aligned.
  131.  
  132.       00   Translation complete; no errors.
  133.  
  134.      >>00   Translation complete; return value is the number of integer or
  135.           real values that completely overflowed during conversion.
  136.           Overflows and NaNs which exist before conversion are not
  137.           included.
  138.  
  139. SSEEEE AALLSSOO
  140.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed
  141.      version of this man page.
  142.